
TMS34010 

Assembly Language Tools 
Reference Card 


Phone Numbers 

Tl Customer Response Center (CRC) 
Hotline: (800) 232-3200 
Graphics Hotline: (713) 274-2340 


Assembler Directives 


.align 

.line line number [.address] 

.bes size in bits 

.list 

.block beginning line number 

.long valuei[.....valuer)] 

.bss symbol, size in bits 

[.word alignment flag] 

.member name.value[,type 
.storage class.size.tag.dims] 

.byte valuejvaluer)] 

.mlib ["]filename["] 

.copy r]filenamer] 

.mlist 

.data 

.mnolist 

.def symboltsymbolf)] 

.nolist 

.double floating-point value 

.option {B\D\F\L\M\T\X} 

.else 

•page 

.end 

.sect "section name" 

.endblock ending line numbei 

symbol .set value 

.endfunc ending line number 

.space size in bits 

.endif 

.stag name.size 

.eos 

.string "string ; "[....."stringr)"] 

.etag name.size 

.sym name,value[,type 

.storage class.size.tag.dims] 

.even 

.field value[.size in bits] 

.text 

.file "filename" 

.ref symboli[,...,symbolr)] 

.float floating-point value 

.title "string" 

.func beginning line number 

symbol .usect "section name" 
.size in bits [.word alignment 
flag] 

.global symboh[.....symbolf)] 

.if expression 

.include ["]filename["] 

.utag name.size 

.int valuej[,....valuer)] 

.width page width 

.length page length 

.word valuei [.....valuer)] 


Sample MEMORY and SECTIONS Linker Directives 

MEMORY 

{ 

display : o = Oh, 1 = OlFFFFOh 

code : o = ODOOOOOOOh, 1 = 03FFFF0h 

space ; o = OFFEOOOOOh, 1 = OlFFFFOh 

} 

SECTIONS 

{ 


.text 

ODOOOOOOOh 

{ 

} 



powers 

ALIGN(32) 

C 

3 

> 

code 

. data 


£ 

3 

> 

code 

newvars 

{ 

3 

> 

space 

.bss 


{ 

3 

> 

space 


Invoking the Assembler 

I gspa input file [object file [listing file]][ options] | 

Options: 

-b makes blanks significant. 

-c makes case insignificant. 

-h allows alternate hex format. 

-i pathname 

specifies a directory where the assembler can find files 
named by the .copy, .include, or .mlib directives. 

-I (lowercase "L") produces a listing file. 

-q suppresses the banner and all progress information. 

-s puts all defined symbols in the object file's symbol table. 
-X produces a cross-reference listing of symbols. 

Invoking the Linker 

I gspink [ options] fHei ... fUen \ 

Options: 

-a produces an absolute, executable module. 

-ar produces a relocatable, executable object module. 

-c uses ROM autoinitialization model (for C code). 

-cr uses RAM autoinitialization model (for C code). 

-e global symbol 

defines the primary entry point for the output module. 

-f 16-bit fill value 

sets the default fill value for holes within output sections, 
-h makes all global symbols static. 

-i pathname 

specifies a directory where the linker can find object li¬ 
braries named with -I. 

-I tibname 

names an object library file as linker input. 

-m map file name 

produces an output map listing. 

-o output file name 

names the executable output module (the default filename 
is a.out). 

-q requests a quiet run (suppress the banner). 

-r retains relocation entries in the output module. 

-s strips symbol table information and tine number entries 
from the output module. 

-u symbol 

places an unresolved external symbol into the output 
module's symbol table. 

Invoking the Archiver 

I gspar [-]commancl[option] libname [fHei ... fUen] \ 

Commands: 

-a adds the specified files to the library. 

-d deletes the specified members from the library. 

-r replaces the specified members in the library. 

-t prints a table of contents of the library. 

-X extracts the specified files. 

Options: 

e tells the archiver not to use the default extension .obj for 
member names. 

q suppresses the banner and status messages, 
s prints a list of the symbols that are defined in the library. 

(Valid only with the -a, -r, and -d commands.) 

V describes the creation of a new library from an old library. 

Invoking the Object Format Converter 

I gsprom [- option] [file y [file2 [files]]] I 

Filename Order: 

1) Input filename 

2) Output filename (Tl-tagged format) or high-byte output 
filename (Tektronix or Intel format) 

3) Low-byte output file (Tektronix or Intel format) 

Options: 

-i produces Intel hex object output. 

-t produces Tl-tagged object output. 

-X produces Tektronix-hex object output (default). 
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Register File B 


Condition Codes for JRcc and JAcc Instructions 


Reg 

Function 

Description 

Reg 

Function 

Description 

BO 

SADDR 

Source address 

B7 

DYDX 

Delta Y/delta X 

B1 

SPTCH 

Source pitch 

B8 

COLORO 

Color 0 

B2 

DADDR 

Destination 

address 

B9 

COLOR1 

Color 1 

BIO 

TEMP 

TEMP 

TEMP 

TEMP 

TEMP 

Used as temp¬ 
orary storage 
for PIXBLTs 
and FILLS 

B3 

DPTCH 

Destination 

pitch 

-Bll 

B12 

B4 

OFFSET 

Offset 

B13 

B14 

B5 

WSTART 

Window start 


B6 

WEND 

Window end 

SP 

SP 

Stack pointer 


fjO Registers 


Address 

Register 

Description 

0C00001 FOh 

REFCNT 

DRAM refresh count 

0C00001EOh 

DPYADR 

Display address 

0C00001 DOh 

VCOUNT 

Vertical count 

0C00001 COh 

HCOUNT 

Horizontal count 

0C00001 BOh 

DPYTAP 

Display tap point 

0C00001 AOh 
0C0000170h 

Reserved 


0C0000160h 

PMASK 

Plane mask 

OCOOOOISOh 

PSIZE 

Pixel size 

OCOOOOUOh 

CONVDP 

Conversion (destination pitch) 

0C0000130h 

CONVSP 

Conversion (source pitch) 

0C0000120h 

INTPEND 

Interrupt pending 

OCOOOOUOh 

INTENB 

Interrupt enable 

0C00001OOh 

HSTCTLH 

Host control high (8 MSBs) 

OCOOOOOFOh 

HSTCTLL 

Host control low (8 LSBs) 

OCOOOOODOh 

HSTADRH 

Host address high (16 MSBs) 

OCOOOOOEOh 

HSTADRL 

Host address low (16 LSBs) 

OCOOOOOCOh 

HSTDATA' 

Host data 

OCOOOOOBOh 

CONTROL 

I/O control 

OCOOOOOAOh 

DPYINT 

Display interrupt 

OCOOOOOSOh 

DPYSTRT 

Display start 

OCOOOOOBOh 

DPYCTL 

Display control 

0C0000070h 

VTOTAL 

Vertical total 

OCOOOOOBOh 

VSBLNK 

Vertical start blank 

OCOOOOOBOh 

VEBLNK 

Vertical end blank 

0C0000040h 

VESYNC 

Vertical end sync 

OCOOOOOBOh 

HTOTAL 

Horizontal total 

0C0000020h 

HSBLNK 

Horizontal start blank 

0C000001 Oh 

HEBLNK 

Horizontal end blank 

OCOOOOOOOh 

HESYNC 

Horizontal end sync 


Vector Address Map 


Trap# 

Address 

Desc 

Trap# 

Address 

Desc 

0 

OFFFFFFEOh 

RESET 

16 

OFFFFFDEOh 


1 

OFFFFFFCOh 

INTI 

17 

OFFFFFDCOh 


2 

OFFFFFFAOh 

INT2 

18 

OFFFFFDAOh 


3 

OFFFFFFBOh 


19 

OFFFFFDBOh 


4 

0FFFFFF60h 


20 

0FFFFFD60h 


5 

0FFFFFF40h 


21 

0FFFFFD40h 


6 

0FFFFFF20h 


22 

0FFFFFD20h 


7 

OFFFFFFOOh 


23 

OFFFFFDOOh 


8 

OFFFFFEEOh 

NMI 

24 

OFFFFFCEOh 


9 

OFFFFFECOh 

HI 

25 

OFFFFFCCOh 


10 

OFFFFFEAOh 

Dl 

26 

OFFFFFCAOh 


11 

OFFFFFEBOh 

WV 

27 

OFFFFFCBOh 


12 

0FFFFFE60h 


28 

0FFFFFC60h 


13 

0FFFFFE40h 


29 

0FFFFFC40h 


14 

0FFFFFE20h 


30 

0FFFFFC20h 

ILLOP 

15 

OFFFFFEOOh 


31 

OFFFFFCOOh 



Unconditional Compares 

Mnemonic 

Code 

Result of Compare 

Status Bits 

Code 

uc 1 - 

Unconditional 

don't care 

0000 

Unsigned Compares 

Mnemonic 

Code 

Result of Compare 

Status Bits 

Code 

LO 

(C) 


Dst lower than Src 

C 

0001 

LS 

YLE 

Dst lower than or 
same as Src 

C + Z 

0010 

HI 

YGT 

Dst higher than src 

Z . 2 

0011 

HS 

(NC) 

— 

Dst higher than or 
same as Src 

Z 

1001 

EQ 

(Z) 


Dst = Src 

z 

1010 

NE 

(NZ) 

V 

Dst ^ Src 

2 

1011 

Signed Compares 

Mnemonic 

Code 

Result of Compare 

Status Bits 

Code 

LT 

XLE 

Dst < Src 

(N . V) + 

(fJ • V) 

0100 

LE 

- 

Dst ^ Src 

(N . V) + 

(N . V) + Z 

0110 

GT 


Dst > Src 

(N . V . Z) + 
(N . V . Z) 

0111 

GE 

XGT 

Dst ^ Src 

(N . V) + 

(TJ . V) 

0101 

EQ 

(Z) 

— 

Dst = Src 

z 

1010 

NE 

(NZ) 

“ 

Dst ^ Src 

z 

1011 

Compare to Zero 

Mnemonic 

Code 

Result of Compare 

Status Bits 

Code 

Z 

YZ 

Result = zero 

Z 

0101 

NZ 

YNZ 

Result is nonzero 

Z 

1011 

P 

- 

Result is positive 

N . Z 

0001 

N 

xz 

Result is negative 

N 

1110 

NN 

XNZ 

Result is nonnegative 

N. 

1111 

Genera! Arithmetic 

Mnemonic 

Code 

Result of Compare 

Status Bits 

Code 

Z 

YZ 

Result is zero 

Z 0 

1010 

NZ 

YNZ 

Result is nonzero 

2 

1011 

C 

YN 

Carry set on result 

C 

1000 

NC 

YNC 

No carry on result 

Z 

1001 

B 

(C) 


Borrow set on result 

C 

1000 

NB 

(NC) 


No borrow on result 

z 

1001 

vt 

XN 

Overflow on result 

V 

1100 

NVt 

XNN 

No overflow on result 

V 

1101 


Note: A mnemonic code in parentheses is an alternate code for 
the preceding code, 
t Also used for window clipping 
+ Logical OR 
^ Logical AND 
Logical NOT 
































































































































Enwironment Variables 

The environment variable for the assembler is A—DIR. The 
environment variable for the linker Is C— DIR. 



Set 

Reset 

DOS 

set A-DIR=par/7;; ... :pathn 
set C—DIR=psr/?/; ... ;pathn 

set A_DIR= 

set C DIR = 

VMS 

assign A—DIR "pathy. ... ;pathn " 
assign C—DIR "pathy ... :pathn " 

deassign A_DIR 
deassign C—DIR 

UNIX 

setenv A_DIR "pathy ... :pathn" 
setenv C—DIR "pathy. ... ;pathn' 

setenv A_DIR " " 

setenv C—DIR " " 


TMS34010 Instruction Set 


Syntax 

Operation 

ABS Rd 

|Rd| -♦ Rd 

ADD Rs, Rd 

Rs + Rd Rd 

ADDC Rs. Rd 

Rs + Rd + C Rd 

ADDI /IV, Rd. /W; 

16-bit immediate value + Rd Rd 

ADDI IL, Rd. [L] 

32-bit immediate value + Rd ”♦ Rd 

ADDK K. Rd 

K + Rd Rd 

ADDXY Rs. Rd 

Rs X + RdX -► RdX 

RsY + RdY RdY 

AND Rs. Rd 

Rs AND Rd -► Rd 

ANDI IL. Rd 

IL AND Rd -► Rd 

ANDN Rs. Rd 

(NOT Rs) AND Rd Rd 

ANDNI IL. Rd 

(NOT IL) AND Rd Rd 

BTST K. Rd 

Set status on value of; 
bit K in Rd 

BTST Rs. Rd 

Set status on; 

value of a bit in Rd (Rs specifies a 
bit number) 

CALL Rs 

PC' TOS 

Rs PC 

SP -32 SP 

CALLA Address 

PC' -♦ TOS 

Address -♦ PC 

CALLR Address 

PC' -♦ TOS 

PC' + (displacement x 16) -► PC 

CLR Rd 

Rd XOR Rd Rd 

CLRC 

0 C 

CMP Rs.Rd 

Set status bits on result of; 

Rd - Rs 

CM PI iw. Rd. /w; 

Set status bits on the result of; 

Rd - 16-bit Immediate value 

CM PI IL. Rd. [L] 

Set status bits on the result of; 

Rd - 32-bit immediate value 

CMPXY Rs. Rd 

Set status bits on the results of; 

RdX - RsX 

RdY - RsY 

CPW Rs. Rd 

point code -♦ Rd 

CVXYL Rs. Rd 

XY address in Rs -♦ linear address in Rd 

DEC Rd 

Rd - 1 Rd 

DINT 

0 -► IE 

DIVS Rs. Rd 

Rd even; Rd;Rd + 1 / Rs Rd 

Remainder -Rd + I 

Rd odd; Rd / Rs -► Rd 

DIVU Rs. Rd 

Rd even. Rd;Rd + 1 / Rs -► Rd 

Remainder -♦ Rd + 1 

Rd odd; Rd / Rs -♦ Rd 


TMS34010 Instruction Set 


Syntax 

Operation 

DRAV Rs. Rd 

COLOR1 pixel value -► *Rd 

RsX + RdX -► RdX 

RsY + RdY RdY 

DSJ Rd. Address 
DSJS Rd. Address 

Rd - 1 -► Rd 

If Rd 0 

(disp. X 16) + PC' -► PC 

If Rd = 0 

go to next instruction 

DSJEQ Rd. Address 

■ 

If Z = 1 

Rd - 1 Rd 

If Rd 0 

(disp. X 16) + PC' PC 

If Rd = 0 

go to next Instruction 

If Z = 0 

go to next instruction 

DSJNE Rd. Addres. 

■ 

If Z = 0 

Rd - 1 Rd 

If Rd 94 0 

(disp. X 16) + PC' PC 

If Rd = 0 

go to next instruction 

If Z - 1 

go to next instruction 

EINT 

1 IE 

EMU 

ST Rd 

Conditionally enter emulator mode 

EXGP Rd [. F] 

Rd FSO, FEO or Rd -► FS1, FE1 

FSO, FEO -► Rd or FS1, FE1 -♦ Rd 

EXGPC Rd 

Rd -► PC 

PC' Rd 

FILL L 

CO LORI pixel values -► pixel array 
(linear source address) 

FILL XY 

CO LORI pixel values pixel array 
(XY source address) 

GETPC Rd 

PC' -► Rd 

GETST Rd 

ST -► Rd 

INC Rd 

PC + 1 -♦ Rd 

JAcc Address 

If cc = true 

Address -♦ PC 

If cc = false 

go to next instruction 

JRcc Address 

If cc = true 

disp. + PC' -♦ PC 

If cc = false 

go to next instruction 

JUMP Rs 

Rs PC 

LINE/0 . ^] 

Perform the inner loop of Bresenham's 
line-drawing algorithm. 

LMO Rs. Rd 

31 - bit number of leftmost 1 in Rs Rd 

MMFM Rs [. reg. 1 

St] 

If Register /? is in the register list 

* Rs+ -♦ Rr? (repeat for /? = 0 to 15) 

MMTM Rdf. reg. i 

ist] 

If Register n is in the register list 

R/? -► - * Rd (repeat for /? = 0 to 15) 

MODS Rs. Rd 

Rd mod Rs “♦ Rd 

MODU Rs. Rd 

Rd mod Rs Rd 

MOVB 

See MOVB summary 

MOVE 

See MOVE summary 

MOVI IW. Rd. f\NJ 

16-bit immediate operand Rd 

MOVI IL. Rd. [L] 

32-bit immediate operand Rd 









































































TMS34010 Instruction Set 


Syntax 

Operation 

MOVK K, Rd 

K -♦ Rd 

MOVX Rs, Rd 

Rs X -► RdX 

MOVY Rs, Rd 

Rs Y -► RdY 

MPYS Rs, Rd 

Rd even: Rs x Rd -♦ Rd:Rd+1 

Rd odd: Rs x Rd -► Rd 

MPYU Rs, Rd 

Rd even: Rs x Rd Rd:Rd + 1 

Rd odd: Rs x Rd Rd 

NEG Rd 

-Rd Rd 

NEGB Rd 

-Rd - C -► Rd 

NOP 

No operation 

NOT Rd 

NOT Rd -♦ Rd 

OR Rs, Rd 

Rs OR Rd Rd 

ORI IL, Rd 

IL OR Rd -♦ Rd 

PIXBLT 

See PIXBLT summary 

PIXT 

See PIXT summary 

POPST 

*SP+ -► ST 

PUSHST 

ST -*SP 

PUTST Rs 

Rs -► ST 

RETI 

*SP+ -► ST 
*SP+ -► PC 

RETS [N] 

*SP -► PC (N defaults to 0) 

SP + 32 + 16N SP 

REV Rd 

revision number Rd 

RL K, Rd 

Rd rotated left by K -♦ Rd 

RL Rs, Rd 

Rd rotated left by Rs -► Rd 

SETC 

1 -♦ C 

SETFfS, FE [, F] 

(FS, FE) -► ST 

SEXT Rd [, F] 

field in Rd -* sign-extended field in Rd 

SLA K, Rd 

left-shift Rd by K -► Rd 

SLA Rs, Rd 

left-shift Rd by Rs Rd 

SLL K, Rd 

left-shift Rd by K -♦ Rd 

SLL Rs, Rd 

left-shift Rd by Rs -*• Rd 

SR A K, Rd 

right-shift Rd by K Rd 

SR A Rs, Rd 

right-shift Rd by Rs “♦ Rd 

SRL AT, Rd 

right-shift Rd by K Rd 

SRL Rs, Rd 

right-shift Rd by Rs Rd 

SUB Rs, Rd 

Rd - Rs Rd 

SUBB Rs, Rd 

Rd - Rs - C Rd 

suBi /w, Rd, /w; 

Rd - 16-bit immediate value -► Rd 

SUBI IL, Rd, [L] 

Rd - 32-bit immediate value Rd 

SUBK K, Rd 

Rd - K Rd 

SUBXY Rs, Rd 

Rd X - RsX RdX 

RdY - RsY RdY 

TRAP N 

PC -► -*SP 

ST -*SP 
trap vector /V PC 

XOR Rs, Rd 

Rs XOR Rd -► Rd 

XORI IL, Rd 

IL XOR Rd -► Rd 

ZEXT Rd [, F] 

field in Rd zero-extended field in Rd 


Ke 

Rs 

Rd 

IW 


K 

PC' 


ource register RsX, RdX -X half (16 LSBs) of Rs or Rd 
•Destination register RsY, RdY -Y half (16 MSBs) of Rs or Rd 
■16-bit (short) SAddress-32-bit source address 

immediate value DAddress-32-bit destination address 

■32-bit (long) Address -32-bit address (label) 

immediate value F -Field select defaults to 0 

■5-bit constant F=0 selects FSO and FEO 

■Next instruction F=1 selects FS1 and FE1 


MOVE Instructions Summary 



Destination 

Source 

Rd 

*/?d 

*/?£/+ 

-*A?d 

*R dioffset) 

@D Address 

Rs 

7 

7 

7 

7 

^/ 

1 

V 

*Rs 

7 

7 





*Rs+ 

V 


7 




-*Rs 

V 



7 



*Rsioffset) 

V 


7 


7 


Address 

V 


7 



7 


A check mark (■>/) in a box indicates a valid combination of 
source and destination operands. For example, 

MOVE/?s, *Rd{offset) 

is a valid form of the MOVE instruction. 


MOVB Instructions Summary 



Destination 

Source 

Rd 


Rdioffset) 

(^D Ad dress 

Rs 



7 

7 

*Rs 

7 

7 



* Rsioffset) 

V 


7 


Address 

7 



7 


A check mark (V) in a box indicates a valid combination of 
source and destination operands. For example, 

MOVB Rs, *Rdioffset) 

is a valid form of the MOVB instruction. 


PIXT Instructions Summary 



Destination Pixel 

Source 

Pixel 

Rd 

■^Rd 

*Rd.XY 

Rs 


v 

V 

*Rs 

7 

7 


*Rs.XY 

7 


7 


A check mark {yj) in a box indicates a valid combination of 
source and destination operands. For example, 

PIXT */?s, Rd 

is a valid form of the PIXT instruction. 

PIXBL T Instructions Summary 



Destination Array 

Source 

Array 

L 

XY 

B 

7 

v 

L 

7 

7 

XY 

V 

V 


B “ Binary array address 
L " Linear array address 
XY“ XY array address 

A check mark (>/) in a box indicates a valid combination of 
source and destination array types. For example. 


PIXBLT B, XY 

is a valid form of the PIXBLT instruction. 



































































































